/**********************************************************************
** Copyright (C) 2000-2005 Trolltech AS.  All rights reserved.
**
** This file is part of the Qtopia Environment.
** 
** This program is free software; you can redistribute it and/or modify it
** under the terms of the GNU General Public License as published by the
** Free Software Foundation; either version 2 of the License, or (at your
** option) any later version.
** 
** A copy of the GNU GPL license version 2 is included in this package as 
** LICENSE.GPL.
**
** This program is distributed in the hope that it will be useful, but
** WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
** See the GNU General Public License for more details.
**
** In addition, as a special exception Trolltech gives permission to link
** the code of this program with Qtopia applications copyrighted, developed
** and distributed by Trolltech under the terms of the Qtopia Personal Use
** License Agreement. You must comply with the GNU General Public License
** in all respects for all of the code used other than the applications
** licensed under the Qtopia Personal Use License Agreement. If you modify
** this file, you may extend this exception to your version of the file,
** but you are not obligated to do so. If you do not wish to do so, delete
** this exception statement from your version.
** 
** See http://www.trolltech.com/gpl/ for GPL licensing information.
**
** Contact info@trolltech.com if any conditions of this licensing are
** not clear to you.
**
**********************************************************************/

#ifndef ADDRESSBOOK_ACCESS_H
#define ADDRESSBOOK_ACCESS_H

#include <qobject.h>
#include <qvaluelist.h>
#include <qtopia/pim/contact.h>

class ContactIO;
class AddressBookAccess;
class ContactIteratorMachine;

class QTOPIAPIM_EXPORT AddressBookIterator 
{
    friend class AddressBookAccess;
public:
    AddressBookIterator(ContactIteratorMachine *);
    AddressBookIterator(const ContactIO &);
    AddressBookIterator(const AddressBookAccess &);
    AddressBookIterator(const AddressBookIterator &);
    AddressBookIterator &operator=(const AddressBookIterator &);
    ~AddressBookIterator();

    bool atFirst() const;
    bool atLast() const;
    const PimContact *toFirst();
    const PimContact *toLast();

    const PimContact *operator++();
    const PimContact *operator*() const;

    const PimContact *current() const;

private:
    ContactIteratorMachine *machine;
};

class QTOPIAPIM_EXPORT AddressBookAccess : public QObject {
  Q_OBJECT

    friend class AddressBookIterator;
  public:

  AddressBookAccess();
  
  ~AddressBookAccess();

  bool editSupported() const;

  void updateContact(const PimContact& contact);

  void removeContact(const PimContact& contact);
  
  void addContact(const PimContact& contact);

  PimContact personalDetails() const;

  PimContact contactForId(const QUuid &, bool *ok = 0) const;

 signals:
  void addressBookUpdated();

 private:
  ContactIO* m_AccessPrivate;
};


#endif

